package com.tju.ocean_ecology_website.service;

import com.tju.ocean_ecology_website.entity.FileUpload;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.Map;

/**
 * 文件上传记录表(FileUpload)表服务接口
 *
 * @author shaolong
 * @since 2025-05-10 10:00:00
 */
public interface FileUploadService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    FileUpload queryById(Long id);

    /**
     * 分页查询
     *
     * @param fileUpload 筛选条件
     * @param pageRequest 分页对象
     * @return 查询结果
     */
    Page<FileUpload> queryByPage(FileUpload fileUpload, PageRequest pageRequest);

    /**
     * 新增数据
     *
     * @param fileUpload 实例对象
     * @return 实例对象
     */
    FileUpload insert(FileUpload fileUpload);

    /**
     * 修改数据
     *
     * @param fileUpload 实例对象
     * @return 实例对象
     */
    FileUpload update(FileUpload fileUpload);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);

    /**
     * 上传文件
     *
     * @param file 文件对象
     * @param type 文件类型
     * @param userId 用户ID
     * @return 文件上传记录
     * @throws IOException IO异常
     */
    FileUpload uploadFile(MultipartFile file, String type, Long userId) throws IOException;

    /**
     * 根据上传类型和用户ID查询文件列表
     *
     * @param type 上传类型
     * @param userId 用户ID
     * @param pageRequest 分页对象
     * @return 文件列表
     */
    Page<FileUpload> queryByTypeAndUserId(String type, Long userId, PageRequest pageRequest);

    /**
     * 更新业务表中的图片URL
     *
     * @param type 上传类型
     * @param fileUrl 文件URL
     * @param targetId 目标记录ID
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean updateBusinessImageUrl(String type, String fileUrl, Long targetId, Long userId);

    /**
     * 上传文件并更新业务表
     *
     * @param file 文件对象
     * @param type 文件类型
     * @param targetId 目标记录ID
     * @param userId 用户ID
     * @return 文件上传记录和更新结果
     * @throws IOException IO异常
     */
    Map<String, Object> uploadFileAndUpdateBusiness(MultipartFile file, String type, Long targetId, Long userId) throws IOException;
}
